home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / utilit~1 / groffvar.zoo / install < prev    next >
Encoding:
Text File  |  1993-03-06  |  3.7 KB  |  84 lines
  1. This file explains how to install GNU groff 1.07 on your Atari ST.
  2.  
  3. First of all, the requirements are repeated. If your machine is not up
  4. to these, forget about installing groff. Sorry!
  5. - Atari ST running MiNT
  6. - 2 Mb or more RAM
  7. - 1.5 Mb TOS/minix harddisk space for the binaries
  8. - 1.4 minix harddisk space for the libraries and manpages. You can use
  9.   a TOS partition, but I advise against it.
  10. - A good tar, preferably GNU tar 1.10 or later
  11.  
  12.  
  13. Installation:
  14. - Unzoo both archives. Since you're reading this file, I presume you
  15.   did that already. Any kind of disk partition is okay, so don't worry
  16.   if you unzoo'd groffvar.zoo on a TOS partition.
  17. - All files from groffbin go to a directory in your search path.
  18.   You can copy them to /bin; I put them in /gnu/groffbin and added that
  19.   to my search path.
  20. - Use a good tar to untar groffbin.tar. It should be untar-ed in /usr/lib.
  21.   The tarfile extracts a groff/ subdirectory of some 1.2 Mb, /usr/lib/groff.
  22.   You can put it anywhere else, but you'll have to set some environment
  23.   variables (see below) or make a symbolic link to wherever you put it.
  24. - Use a good tar to untar groffman.tar. It will extract a groffman/
  25.   subdirectory of some 200 Kb. Copy the contents of the subdirectories
  26.   to your man directories (NOT using the desktop: use a shell).
  27.   So, groffman/man1/* should go to something like /usr/man/man1.
  28. - You're almost done! Now decide on your default device for output.
  29.   The default is `ascii'; if you want something else, set the environment
  30.   variable GROFF_TYPESETTER (see below).
  31.  
  32.   
  33. Environment variables:
  34. Set the following environment variables if you want a non-standard path
  35. for your files, if you want another default device, or whatever.
  36.  
  37. GROFF_TMAC_PATH:
  38.   A colon-separated list of directories in which to search for macro files.
  39.   The default is ".:/usr/lib/groff/tmac:/usr/lib/font".
  40.  
  41. GROFF_TYPESETTER
  42.   The default device. This is the output device chosen when no device
  43.   is specified on the command line. The default is "ascii".
  44.  
  45. GROFF_FONT_PATH
  46.   A colon-separated list of directories in which to search for the dev*
  47.   directories. Troff will search in the directories specified by the
  48.   -F command-line option before these, and in
  49.   ".:/usr/lib/groff/font:/usr/lib/font:/lib/font" after these.
  50.  
  51. GROFF_HYPHEN
  52.   The file containing hyphenation patterns. The default is
  53.   /usr/lib/groff/tmac/hyphen.us.
  54.   
  55. GROFF_TMPDIR
  56.   The directory for temporary files. If this is not set, $TMPDIR
  57.   will be used. If that isn't set either, /tmp will be used.
  58.   
  59.  
  60. Saving space:
  61. If you want to save on the disk space used, you can delete fonts,
  62. macros and programs you don't need.
  63. For instance, if you don't need any PostScript support, you can delete
  64. /usr/lib/groff/font/devps and all the programs supporting PostScript.
  65. If you don't need -me macros, you can delete /usr/lib/groff/tmac/tmac.e.
  66. Be careful, however: some programs are run by other programs, and some]
  67. macro-packages are silently included. For instance, nroff always gives
  68. a -mtty-char parameter to groff,  which means 
  69. /usr/lib/groff/tmac/tmac.tty-char is read. So, don't delete blindly or
  70. keep a backup of the archives near!
  71.  
  72.  
  73. Good luck! If you experience any problems, or wish a clearer explanation,
  74. please mail me. I'll treat any such problems as a bug-report,
  75. which means that:
  76. a) You're welcome (don't be ashamed to mail me with problems).
  77. b) I'll try to answer you soonest.
  78. c) I'll try to fix any flaws in future releases. So, mailing me
  79.    with a problem or a solution will help not just you, but also
  80.    many other people out there.
  81.  
  82. Bye, Hildo Biersma
  83. boender@dutiws.twi.tudelft.nl // schuller@dutiag.twi.tudelft.nl
  84.